home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 19 / Amiga Format CD19 (1997-10-02)(Future Publishing)(GB)(Track 1 of 5)[!][issue 1997-11].iso / -seriously_amiga- / shareware / sound / quicksamplerv15 / quicksampler_d.dok < prev    next >
Text File  |  1997-08-18  |  17KB  |  412 lines
  1.  
  2.                            QUICKSAMPLER  ©
  3.                           -----------------
  4.  
  5.               Ein Programm um digitale Audio-Daten (CDDA) von CDs
  6.                                 zu lesen!
  7.                    QUICKSAMPLER V1.5  © 1996/1997 by Mario Kubek
  8.                            ALL RIGHTS RESERVED!
  9.                          Alle Rechte vorbehalten!
  10.                         Version 1.5 (30.07.1997)
  11.                    Datum der letzten Änderung: 31.07.1997.
  12.                             Autor: Mario Kubek
  13.                          Dieses Programm ist Freeware!
  14.  
  15. 1. Das Programm
  16.  
  17.  1.1    Einführung        -  Was ist QUICKSAMPLER?
  18.  1.2    Voraussetzungen   -  Was wird benötigt?
  19.  1.3    Besonderheiten    -  Spezielle Eigenschaften!
  20.  1.4    Installation      -  Wohin installieren?
  21.  1.5    Funktionen        -  Beschreibung der GUI und der TOOLTYPES
  22.  1.6    Kompatibilität    -  Welche Laufwerke wurden getestet?
  23.  1.7    Fehlermeldungen   -  Hoffentlich werden Sie sie nie sehen!
  24.  1.8    Bugs              -  Immer diese BUGS!
  25.  
  26. 2. Geschichte und Zukunft
  27.  
  28. 2.1    Geschichte von QUICKSAMPLER   -  Was ist neu in dieser Version?
  29. 2.2    Zukunftsaussichten  -  Was kann in der Zukunft erwartet werden?
  30.  
  31.  
  32. 3. Wichtige zusätzliche Informationen
  33.  
  34. 3.1    Autor,Updates,Sourcecode,Registrierung - Zur Info!
  35. 3.2    Copyright und Rechtliches - Bitte, lesen Sie es!
  36.  
  37.  
  38. 4. Danksagungen
  39.  
  40.        Danke      -  Dankeschön an ...
  41.  
  42.  
  43. 1.1 Einführung
  44.  
  45. QUICKSAMPLER ist ein Program um digitale Audio-Daten (CDDA) von CD's
  46. mit speziellen CD-ROM Laufwerken, welche in der Lage sind digitale
  47. Audio-Daten (16bit) über den SCSI-Bus zu senden, zu lesen.
  48. Diese Daten können in einer Datei auf einem Datenträger gespeichert
  49. werden. Diese Version funktioniert mit TOSHIBA CD-ROM Laufwerken.
  50.  
  51.  
  52. 1.2 Voraussetzungen
  53.  
  54. Um das Programm zu betreiben braucht man mindestens einen AMIGA (klar!)
  55. mit 68020 Prozessor (oder höher) und einen SCSI-Controller mit CD-ROM
  56. Laufwerk, welches digitale Audio-Daten (16bit) über den SCSI-Bus senden
  57. kann. Die meisten Laufwerke bieten diesen Luxus leider nicht an.
  58. Bitte werfen Sie einen Blick auf die Kompatibilitätsliste um zu erfahren,
  59. ob Ihr Laufwerk diese Fähigkeit hat.
  60. Ich empfehle die Benutzung von TOSHIBA CD-ROM Laufwerken. Ich besitze
  61. das TOSHIBA XM-5301B. Es arbeitet sehr gut mit dem Program zusammen.
  62.  
  63. Kickstart 3.0 wird benötigt, aber es sollte auch mit Kickstart 2.xx
  64. funktionieren (nicht getestet!).
  65.  
  66. 1.3 Besonderheiten
  67.  
  68. QUICKSAMPLER V1.0 kann...
  69.  
  70. ...sehr schnell CDDA Daten (ganze Songs oder Teile davon) in Dateien
  71.    auf Datenträger schreiben.
  72. ...kann die Audio-Daten in den Formaten CDR, RAW, 8SVX speichern.
  73. ...die Samplefrequenz der CDDA Daten ändern: 44100 (44.1 kHz),
  74.    22050 (22.05 kHz), 14700 (14.70 kHz), 11025 (11.025 kHz)
  75. ...die Byteausrichtung ändern (MSB [Motorola Format] als erstes oder
  76.    LSB [Intel Format] als erstes) wenn rohe 16bit Daten gespeichert
  77.    werden.
  78. ...in der Ausgabedatei die Kanäle verändern: STEREO, CHANGE STEREO
  79.    CHANNELSIDE (was man sonst vom CD-Lautsprecher auf der linken Seite
  80.    hört befindet, sich in der Datei als rechter Kanal, und umgekehrt),
  81.    LEFT ON BOTH CHANNELS
  82.    (was man sonst vom CD-Lautsprecher auf der linken Seite hört, befindet
  83.    sich in der Datei auch als rechter Kanal; der rechte Audio-Kanal auf
  84.    der CD wird nicht beachtet), RIGHT ON BOTH CHANNELS
  85.    (was man sonst vom CD-Lautsprecher auf der rechten Seite hört, befindet
  86.    sich in der Datei auch als linker Kanal; der linke Audio-Kanal auf
  87.    der CD wird nicht beachtet),
  88.    MONO (der rechte und linke Audio-CD Kanal werden addiert und durch 2
  89.    dividiert),
  90.    MONO_LEFT (in der Ausgabedatei befinden sich nur Daten des linken
  91.              Audio-CD Kanals),
  92.    MONO_RIGHT (in der Ausgabedatei befinden sich nur Daten des rechten
  93.               Audio-CD Kanals).
  94. ...eine gutaussehende Fortschrittsanzeige anbieten.
  95. ...die Größe der Ausgabedatei mittels der GUI anzeigen.
  96.  
  97.    QUICKSAMPLER überprüft vor dem Schreiben in eine Datei, ob noch
  98.    genügend freier Speicherplatz vorhanden ist.
  99.    Stellen Sie sich vor, daß Sie eine Datei erstellen wollen, deren
  100.    Größe über den noch verfügbaren Speicherplatz hinausgeht. Dann
  101.    erstellt QUICKSAMPLER diese Dateu auch und setzt deren Dateigröße.
  102.    Dabei wird/kann es passieren, daß das Ende des freien Speicherraumes
  103.    erreicht wird. In diesem Fall schließt und löscht QUICKSAMPLER die
  104.    nicht voll beschriebene Datei. Wer will schon unvollständige Daten?
  105.    Einige andere Programme überprüfen nicht vorher den freien Platz
  106.    auf dem Datenträger. Sie schreiben einfach die Audio-Daten in die
  107.    Datei nachdem sie erstellt worden ist. So konnte es passieren, daß
  108.    während des Schreibeprozesses (sagen wir 1 oder 2 Minuten später)
  109.    die Meldung "DISK FULL" erscheint. Was nun? Der Benutzer verliert
  110.    Zeit und Audio-Daten, welche ja eigentlich in der Datei sein sollten.
  111.  
  112.  
  113.    QUICKSAMPLER verschwendet keinen RAM-Speicher. Die Größe des
  114.    alloziierten Speichers wird durch das WB-Tooltype "BUFBLOCKS"
  115.    oder mit dem CLI-argument "BUBLOCKS" bestimmt.
  116.    BUBLOCKS kann eine Nummer zwischen 0 und 65 sein. Je kleiner
  117.    die Zahl, desto kleiner ist der alloziierte Speicher, und
  118.    QUICKSAMPLER muß öfters von der CD lesen. Je größer die Zahl ist,
  119.    desto größer ist der alloziierte Speicher, und QUICKSAMPLER muß
  120.    seltener von der CD lesen! Die voreingestellte Nummer ist 32.
  121.    Es gibt 3 Buffer, die alloziiert werden müssen.
  122.    Die Größen von ihnen werden mit den folgenden Formeln berechnet:
  123.    (BUBLOCKS*2352/eine_Nummer_zwischen_1_und_17) oder
  124.    (BUBLOCKS*2352*2) wenn Daten als RAW 16bit STEREO 44.1 kHz verändert
  125.    (Kanalveränderung) und gespeichert werden. Letztlich werden in der
  126.    Lade- und Speicherroutine nur 2 Buffer benötigt, je nach Art des
  127.    Dateispeicherformats!
  128.  
  129.    QUICKSAMPLER bietet eine schnell Lese- und Schreibroutine (auch für
  130.    STEREO IFF-8SVX Dateien) an.
  131.    Es ist nicht so aufwendig solch eine Routine zu schreiben, wie Sie
  132.    sich vielleicht vorstellen.
  133.  
  134.  
  135. ACHTUNG:   Die beste Qualität 44.1kHz ist oft reine Platzverschwendung,
  136.            weil das menschliche Ohr (nur) Töne bis ungefähr 20 kHz
  137.            wahrnehmen kann. Ich schlage die Samplingrate 22050 vor.
  138.            Der Platzgewinn bei großen Dateien ist enorm (immer 50%).
  139.            Das heißt, eine Datei mit 22.05 kHz ist halb so groß wie
  140.            eine Datei mit 44.1 kHz.
  141.  
  142.  
  143. 1.4 Installation
  144.  
  145. Ziehen Sie einfach das Verzeichnis dieses Programmes (am besten mit
  146. den Dokumentationen) wohin Sie es gern hätten.
  147.  
  148. 1.5 Funktionen
  149.  
  150. Das Program sollte mit den folgenden WB-Tooltypes kontrolliert werden.
  151.  
  152.  
  153. DEVICE=<Ihr_scsi_device>  Voreingestellt ist squirrelscsi.device.
  154. UNIT=<Ihre_unit_Nummer>   Voreingestellt ist 2.
  155. BUBLOCKS=<Eine_Nummer_zwischen_0_und_65> Voeingestellt ist 32.
  156.  
  157.  QUICKSAMPLER verschwendet keinen RAM-Speicher. Die Größe des
  158.    alloziierten Speichers wird durch das WB-Tooltype "BUFBLOCKS"
  159.    oder mit dem CLI-argument "BUBLOCKS" bestimmt.
  160.    BUBLOCKS kann eine Nummer zwischen 0 und 65 sein. Je kleiner
  161.    die Zahl, desto kleiner ist der alloziierte Speicher, und
  162.    QUICKSAMPLER muß öfters von der CD lesen. Je größer die Zahl ist,
  163.    desto größer ist der alloziierte Speicher, und QUICKSAMPLER muß
  164.    seltener von der CD lesen! Die voreingestellte Nummer ist 32.
  165.    Es gibt 3 Buffer, die alloziiert werden müssen.
  166.    Die Größen von ihnen werden mit den folgenden Formeln berechnet:
  167.    (BUBLOCKS*2352/eine_Nummer_zwischen_1_und_17) oder
  168.    (BUBLOCKS*2352*2) wenn Daten als RAW 16bit STEREO 44.1 kHz verändert
  169.    (Kanalveränderung) und gespeichert werden. Letztlich werden in der
  170.    Lade- und Speicherroutine nur 2 Buffer benötigt, je nach Art des
  171.    Dateispeicherformats!
  172.  
  173. DIE GUI (Graphische Benutzeroberfläche):
  174. ----------------------------------------
  175. Alle Schalter sollten selbsterklärend sein.
  176.  
  177.             GADGET                FUNKTION
  178. ----------------------------------------------------------------------
  179. Slider : - "TRACK"                Wahl der Audio-Spur auf einer CD
  180.                                   von welcher gesampled werden soll.
  181.  
  182.          - "FROM"                 Gibt die Startposition für das
  183.                                   Samplen in Minuten und Sekunden.
  184.  
  185.          - "TO"                   Gibt die Endposition für das
  186.                                   Samplen in Minuten und Sekunden.
  187.  
  188. String:  - ""                     Hier sollten die den Namen der
  189.                                   Ausgabedatei eintragen.
  190.                                   DRÜCKEN SIE IMMER DIE EINGABETASTE
  191.                                   ENTER NACHDEM Sie den Namen der Datei
  192.                                   eingegeben haben, oder Sie werden
  193.                                   nicht samplen können, weil das
  194.                                   "DO IT!"-Gadget nicht aktiviert ist.
  195.  
  196. BUTTONS: - "FILE"                 Ein Requester wird erscheinen, in dem
  197.                                   Sie den Namen der Ausgabedatei mit Pfad
  198.                                   angeben können.
  199.  
  200.          - "DO IT!"               Drücken Sie es, und der Sampleprozess
  201.                                   sollte beginnen.
  202.                                   DIESER KNOPF WIRD NUR ERHELLT DAR-
  203.                                   GESTELLT, WENN SIE EINE RICHTIGE UND
  204.                                   MÖGLICHE AUSGEBEDATEI EINGEGEBEN HABEN.
  205.                                   Wenn Ihr Laufwerk das Lesen digitaler
  206.                                   Audio-Daten nicht unterstützt oder es
  207.                                   nicht kompatibel mit TOSHIBA-Laufwerken
  208.                                   ist, werden Sie eine Fehlermeldung er-
  209.                                   halten.
  210.  
  211.          - "ABORT"                Stoppt den Sampleprozess.
  212.  
  213.          - "ABOUT"                Zeigt Informationen über das Programm und
  214.                                   den Autor.
  215.  
  216. CYCLES:  - "CHANNELS"             Lesen Sie sich die Besonderheiten
  217.                                   durch, um eine Liste der Funktionen zu
  218.                                   sehen.
  219.  
  220.          - "FORMAT"               Ändert das Ausgabeformat: RAW, CDR
  221.                                   (Daten ohne Qualitätsverlust),
  222.                                   8SVX (IFF-Format 8bit)
  223.  
  224.          - "BITS"                 Ändert die Bitauflösung (8/16bit),
  225.                                   wenn im RAW-format gespeichert wird.
  226.  
  227.          - "FREQ"                 Ändert die Abtastfrequenz: 44.1 kHz,
  228.                                   22.05 kHz, 14.7 kHz, 11.025 kHz.
  229.  
  230.          - "MSB/LSB"              Ändert die Byteausrichtung, wenn in
  231.                                   RAW 16bit gespeichert wird.
  232.  
  233.  
  234. 1.6 Kompatibilität
  235.  
  236. CD-ROM Laufwerk             funktioniert ja/nein
  237. -------------------------------------------------
  238. -TOSHIBA Laufwerke                j
  239.  seit 3401
  240.  
  241.  
  242.  
  243. Andere könnten funktionieren, aber ich habe sie nicht getestet!
  244. versuchen Sie es mit Ihrem!
  245.  
  246.  
  247. 1.7 Fehlermeldungen
  248.  
  249. Es gibt viele verschiedene Fehlermeldungen in dem Programm. Sie sind
  250. leicht verständlich und müssen hier nicht erklärt werden. In den
  251. meisten Fällen wenn ein Fehler während des Leseprozesses auftritt,
  252. wird das Samplen gestoppt (z.B. wenn Ihr Laufwerk die Funktion des
  253. Lesens digitaler Audio-Daten nicht unterstützt oder wenn es nicht
  254. kompatibel zu TOSHIBA Laufwerken ist oder wenn das Kommando des Lesens
  255. digitaler Audio-Daten nicht kompatibel mit Ihrem Laufwerk ist.
  256.  
  257.  
  258. 1.8 Bugs
  259.  
  260. Derzeit keine bekannt.
  261.  
  262.  
  263. 2.1 Geschichte von QUICKSAMPLER
  264.  
  265. Version 1.00 (Erste Veröffentlichung)
  266.  
  267. Version 1.5  (Zweite Veröffentlichung)
  268.  
  269. Sie beeinhaltet...
  270.  
  271. ...eine beschleunigte Lese- und Schreibroutine.
  272.  
  273. ...eine Überprüfung, in welcher eine Routine automatisch bestimmt,
  274.    ob sich eine CD im Laufwerk befindet (unter Benutzung des
  275.    timer.device).
  276.    In der vorherigen Version wurde diese Überprüfung mit Hilfe von
  277.    IntuiMessages duchgeführt. Wenn Ihr CD-ROM nicht angemeldet war,
  278.    konnte das Pogramm keine IDCMP_DISKINSERTED oder ICDMP_DISKREMOVED
  279.    Nachricht empfangen. Und wenn Sie eine CD eingelegt oder entnommen
  280.    haben, konnte QUICKSAMPLER diesen Diskwechsel nicht bemerken, und
  281.    das Display nicht mit den Daten einer anderen CD aufgefrischt oder
  282.    es wurde nicht geleert, wenn keine CD eingelegt wurde. Deswegen
  283.    mußten Sie das Programm beenden und wieder starten um einen
  284.    etwaigen Diskwechsel sichtbar zu machen.
  285.    Dieses Problem ist nun behoben. Nun überprüft das Programm alle
  286.    zwei Sekunden, ob sich eine CD im Laufwerk befindet oder nicht.
  287.  
  288. ...den voreingestellten "device"-Namen "squirrelscsi.device", da der
  289.    in der ersten Version eingestellte Name "1230scsi.device" bewirkte,
  290.    daß MaxonC++ (nach dem Übersetzen des Quellcodes) einen Teil dieser
  291.    Zeichenkette (das "ice" von "device") unerklärlicherweise als
  292.    Textsymbol im Frequenzeinstellungsgadget erscheinen ließ, wenn man
  293.    auf die Frequenz 14700 Hz schalten wollte.
  294.    Dies ist jedoch kein Programmierfehler, sondern ein Fehler des Compilers,
  295.    denn mit der nun intern verwendeten Zeichenkette "squirrelscsi.device"
  296.    trat der eben beschriebene Fehler nicht auf.
  297.    Dieses Problem ist nun behoben.
  298.  
  299. ...einige interne Verbesserungen.
  300.  
  301.  
  302. 2.2 Zukunftsaussichten
  303.  
  304. - Unterstützung von mehr CD-ROM Laufwerken
  305.  
  306.   wenn Sie irgendwelche Wünsche oder Ideen haben, die die Entwicklung
  307.   von QUICKSAMPLER voranbringen, dann wäre es schön, wenn Sie mit mir
  308.   in Kontakt treten.
  309.  
  310.  
  311. 3.1 Autor,Updates,Sourcecode,Registrierung
  312.  
  313. Das Programm QUICKSAMPLER und dessen Dokumentationen wurden von
  314.  
  315.                 Mario Kubek
  316.  
  317. geschrieben.
  318.  
  319. Schreiben Sie mich unter
  320.                                Mario Kubek
  321.                                Lessingstr. 39
  322.                                D-07318 Saalfeld
  323. an.
  324.  
  325. Fehlerberichte und Ideen, das Programm zu verbessern sind willkommen.
  326.  
  327.  
  328. Wo gibt es Updates?
  329.  
  330. Updates von QUICKSAMPLER finden Sie im Aminet(Aminet/disk/cdrom).
  331.  
  332.  
  333. Das Programm ist in C geschrieben. Sie können den Quellcode erhalten,
  334. wenn Sie mir eine Diskette mit Ihrem Namen in einem Briefumschlag
  335. zusenden.
  336.  
  337. Wenn Sie das Programm gut finden, dann können Sie mir einen kleinen
  338. Geldbetrag in Höhe von etwa 15DM oder US$10 in einem Briefumschlag
  339. (vieleicht mit der Diskette, wenn Sie am Quellcode interessiert sind)
  340. zusenden. Das ist aber ein "Kann" und nicht ein "Muß", weil das
  341. Programm ja Freeware ist.
  342.  
  343. Wenn Sie das getan haben, werden Sie die neueste Version von
  344. QUICKSAMPLER erhalten, und Sie werden ein registrierter Benutzer.
  345.  
  346.  
  347. 3.2 Copyright und Rechtliches
  348.  
  349. Das Programmpaket enthält:
  350. Dokumente: "QUICKSAMPLER_E.guide", "QUICKSAMPLER_E.doc"
  351.            "QUICKSAMPLER_D.guide" und "QUICKSAMPLER_D.dok"
  352. ausführbares Programm:   "QUICKSAMPLER"
  353.  
  354.  
  355. QUICKSAMPLER is Copyright © 1996/1997 by Mario Kubek
  356. QUICKSAMPLER_E.guide is Copyright © 1996/1997 by Mario Kubek
  357. QUICKSAMPLER_E.doc is Copyright © 1996/1997 by Mario Kubek
  358. QUICKSAMPLER_D.guide is Copyright © 1996/1997 by Mario Kubek
  359. QUICKSAMPLER_D.dok is Copyright © 1996/1997 by Mario Kubek
  360.  
  361.  
  362. Alle Rechte vorbehalten.
  363.  
  364. QUICKSAMPLER ist Freeware. Der Autor hat das Copyright für das Programm
  365. "QUICKSAMPLER" und für alle Dokumentationen zur ausführbaren Datei.
  366. Alle Rechte vorbehalten.
  367.  
  368. Das Programmpaket darf solange frei verteilt werden, wie
  369. keine Veränderungen an der ausführbaren Datei und den Dokumenten
  370. vorgenommen werden. Eine kleine Gebühr darf erhoben werden, um die
  371. Vertriebskosten zu decken.
  372.  
  373. QUICKSAMPLER darf nicht für kommerzielle Zwecke jeglicher Art benutzt
  374. werden, und es darf nicht ohne schriftliche Genehmigung des Autor einem
  375. kommerziellen Produkt beigefügt sein.
  376.  
  377. Der Autor kann nicht garantieren, daß das Programm auf Ihrem Computer
  378. läuft.
  379. Der Autor trägt KEINE Verantwortung für beschädigte Amigas, CD-ROM
  380. Laufwerke, eine andere Komponente oder Daten, die mit der Benutzung
  381. von QUICKSAMPLER oder mit dem Gebrauch der Dokumentationen in
  382. Verbindung stehen.
  383. Sie benutzen das Programmpaket auf eigenes Risiko.
  384.  
  385. Es gibt keine Garantie für für weitere Updates. Es gibt auch keine
  386. Garantie, daß Bugs in ihnen entfernt worden sind.
  387.  
  388. Das Programmpaket ist frei von Rechten Dritter.
  389.  
  390. ACHTUNG: In fast allen Fällen ist es illegal eine CD zu kopieren.
  391.          Das schließt ein, daß keine digitale Audio-Daten von einer
  392.          CD gelesen und auf einen Datenträger geschrieben werden.
  393.          Obwohl Sie die CD besitzen, haben Sie keine Rechte an der
  394.          CD. Bitte verletzen Sie NICHT geltende Rechte. Sie sind dafür
  395.          verantwortlich.
  396.  
  397. 4. Danke
  398.  
  399. Danksagungen gehen an:
  400.  
  401. - Thomas Wenzel für sein tolles Prgramm Play16!
  402.  
  403. - TOSHIBA für besten und schnellsten CD-ROM Laufwerke!!!
  404.  
  405. - MAXON für den großartigen C++ Compiler MaxonC++ 4.0 Dev. Professional.
  406.   MaxonC++ is Copyright © 1996 by MAXON Computer GmbH.
  407.  
  408. - Phase 5 für die schnellsten Turbokarten und SCSI-Controller für den
  409.   AMIGA.
  410.  
  411. - Malcolm Harnden für die fünf tollen CDs
  412.